The SeaRates Artificial Intelligence API allows you to ask the AI Assistant chat about everything on logistics and get access to a range of Digital Solutions for shipping from the SeaRates ecosystem.
Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.
AI API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses,
and uses standard HTTP response codes, authentication, and verbs.
1https://ai-api.searates.com
All endpoints are only accessible via HTTPS and are located at ai-api.searates.com
post/client/stream🤖 Intelligent Maritime Assistant
Send natural language queries to our AI assistant and receive intelligent, streaming responses about maritime logistics. The AI automatically identifies your intent and provides relevant information from our comprehensive maritime database.
💡 Query Examples:
"Where is container MSKU7834389?""Tell me about vessel IMO 9686912""What's the freight rate from Shanghai to Long Beach?""How to pack 50 boxes in a 40ft container?""Show freight trends for Asia-Europe route""Calculate emissions for 1000 TEU shipment""Distance from Hamburg to Singapore by sea?"🔄 Streaming Response: The API returns real-time streaming JSON responses, allowing for immediate data delivery as it becomes available.
api_keyExample: ?api_key=123
Content-Typeapplication/json
👤 Client Identifier
Unique identifier for the client session. Used for conversation context and rate limiting. Should be consistent across requests from the same user/session.
Examples:client_123456user_session_abc123api_client_xyz789
Match pattern:^[a-zA-Z0-9_-]+$
💬 Natural Language Query
Your question or request in natural language. The AI will automatically understand the intent and provide relevant maritime logistics information.
Query Types Supported:
"Where is container MSKU7834389?""Tell me about vessel IMO 9686912""Freight rate from Shanghai to Rotterdam?""Pack 100 boxes in 40ft container""Freight trends Asia-Europe route""CO2 emissions for 500 TEU shipment""Sea distance Hamburg to Singapore""What is FCL shipping?"Examples:Where is container MSKU7834389?Tell me about vessel IMO 9686912What's the freight rate from Shanghai to Rotterdam for 40ft container?How to pack 100 boxes (60x40x30cm, 10kg each) in containers?Show me freight index trends for Asia-Europe route last monthWhat's the CO2 emission for shipping 500 TEU from Hamburg to New York?Distance and transit time from Singapore to Los Angeles?What's the difference between FCL and LCL shipping?
1{
2 "response": "SeaRates is a global shipping platform that provides a wide range of services to facilitate international trade and logistics."
3}1{
2 "response": "📊 **Freight Index Analysis**\n\nFreight Index: FIX-FCL-AEJEA-KRPUS\nRoute: Jebel Ali, AE → Pusan, KR\nPeriod: 2025-07-01 to 2025-07-31\nCurrent Rate: $278.33\nAverage Rate: $278.33\nRate Range: $278.33 - $278.33\nChange: remained stable by 0%\nData Points: 31 records\n\n📈 **Recent Rate Trends:**\n1. **2025-07-27:** $278.33\n2. **2025-07-28:** $278.33\n3. **2025-07-29:** $278.33\n4. **2025-07-30:** $278.33\n5. **2025-07-31:** $278.33\n\n*Market analysis powered by SeaRates [Freight Index](https://www.searates.com/freight-index/) tool*"
3}1{
2 "response": "Load calculation completed successfully.\n\n📦 **Container Load Optimization Results**\n\n📋 **Cargo Specifications:**\n• **Boxes**: BOX - 60.000 m³, 10kg each\n\n📦📦⬆️ **Container 1: 40ft High Cube**\n┌─────────────────────────────────────────┐\n│ 📊 **Utilization Summary** │\n├─────────────────────────────────────────┤\n│ 🔢 **Containers needed**: 1 unit(s) │\n│ 📦 **Total packages**: 12 items │\n│ 📐 **Volume used**: 0.72 m³ (0.9%) │\n│ ⚖️ **Weight used**: 120 kg (0.5%) │\n└─────────────────────────────────────────┘\n\n📋 **Items Distribution:**\n• Boxes: **12 items** loaded\n\n🎯 **Efficiency Analysis:**\n• ❌ **Low volume utilization** (0.9%) - Consider smaller container\n• ❌ **Low weight utilization** (0.5%) - Consider optimizing load\n\n💡 **Optimization Tips:**\n• Consider adjusting cargo orientation for better space utilization\n• Mix different cargo types to optimize both volume and weight\n• Check if smaller containers might be more cost-effective\n\n*Powered by SeaRates [Container Load Calculator](https://www.searates.com/container-load-calculator/) tool*"
3}1{
2 "response": "🚢 **Container Tracking Results**\n\n📦 **Container**: MSKU7834389\n🏢 **Shipping Line**: Maersk\n📍 **Current Status**: In Transit\n🌍 **Last Location**: Hamburg, Germany\n📅 **Last Update**: 2025-01-15 14:30 UTC\n\n🗺️ **Journey Timeline:**\n1. **Departure**: Shanghai, China - Jan 1, 2025\n2. **Transit**: Suez Canal - Jan 8, 2025 \n3. **Current**: Hamburg, Germany - Jan 15, 2025\n4. **Expected**: Rotterdam, Netherlands - Jan 18, 2025\n\n📈 **Delivery Status**: On Schedule\n🚚 **Next Update**: Expected in 6 hours\n\n*Real-time tracking powered by SeaRates [Container Tracking](https://www.searates.com/container-tracking/) service*"
3}1{
2 "response": "🚢 **Vessel Information**\n\n**Basic Details:**\n• **Name**: JAMAICA EXPRESS\n• **IMO**: 9686912\n• **MMSI**: 538005959\n• **Call Sign**: V7IL5\n• **Flag**: Marshall Islands (MH)\n• **Type**: Container Ship\n• **Built**: 2015\n\n**Specifications:**\n• **Length**: 271 meters\n• **Width**: 43 meters\n\n📍 **Current Position (AIS):**\n• **Location**: 35.87°N, -5.53°W\n• **Status**: Moored\n• **Speed**: 0 knots\n• **Course**: 135°\n• **Last Update**: 2025-05-23 14:19 UTC\n\n🗺️ **Voyage Information:**\n• **From**: Valencia, Spain (ESVLC)\n• **To**: Tanger Med, Morocco (MAPTM)\n• **Departure**: May 20, 2025 02:34 UTC\n• **Arrival**: May 22, 2025 10:12 UTC\n\n*Vessel data powered by SeaRates [Vessel Tracking](https://www.searates.com/vessel-tracking/) service*"
3}